home *** CD-ROM | disk | FTP | other *** search
/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga1 / diskexc1.lha / DiskExec.DOC < prev    next >
Text File  |  1992-09-02  |  9KB  |  194 lines
  1.                                  DiskExec
  2.                   --------
  3.  
  4. Written By: Yanik Grignon         Technical Writer: Scott Pinard
  5. ----------  10848 Jean-Masse         ----------------  5522 Eadie
  6.         Montreal, Quebec                           Montreal, Quebec
  7.         Canada.  H4J 1S1                   Canada. H4E 3S6
  8.         grignony@jsp.umontreal.ca            ai537@freenet.hsc.colorado.edu
  9.         FidoNet: 1:167/207.0                     FidoNet: 1:167/207.0
  10.         AmigaNet: 40:600/207               AmigaNet: 40:600/207
  11.  
  12.             IRC Nick: RSlayer                          IRC Nick: TritN
  13.  
  14.  
  15. LICENSE:
  16. -------
  17.     This Program is PostCard-Ware and we ask that anyone who finds this program
  18. usefull, and uses it on a regular basis to please send the Requested
  19. Nominal fee of 1 Postcard of your City. (of course 68040 Accelerator would
  20. be nice) :) Considering the Hard work that went into this Program to keep its
  21. sized down to a minimum, and insure it be Bug free before its release, we are
  22. not asking very much. Also to encourage the Programer to Continue Working on
  23. Great programs for all to enjoy. We are thinking of working on a Much more
  24. Configurable Version that will not be Limited to just Disk Inserts and Removes.
  25. We hope to support Window Opens/Closes, Double Clicks,etc..)  Please send
  26. your PostCards to Yanik Grignon or Scott Pinard at the Adresses Above.
  27.  
  28. Note: Please Indicate any comment or Bugs (Yeah Right!) on the Postcard as
  29. well as the Setup your using DiskExec on. Thank you for your Support.
  30.  
  31.  
  32. DISTRIBUTION OF DISKEXEC:
  33. ------------------------
  34.     You can freely distribute DiskExec as long as the Following is
  35.     Observed:
  36.  
  37.     -   The program and documentation must be distributed together and 
  38.     not modified in any way.  The only exception is that the program and
  39.     documentation may be compressed into an archive for uploading to
  40.     Bulletin Boards or for other electronic transmission.
  41.  
  42.     -   The program is not to be included in a commercial package for profit
  43.     unless written authorisation from Yanik Grignon is obtained first. This
  44.     version of DiskExec may be freely included on public domain library disks
  45.     or compilation disks provided only a small fee is charged for the service.
  46.  
  47.  
  48. CONTENTS OF ARCHIVE:
  49. -------------------
  50. - DiskExec          - The Commodity Program.
  51. - DiskExec.info     - The Icon for DiskExec. (Contains the Datatypes for DE)
  52. - DiskExec.doc      - The File your Currently reading :)
  53. - DiskExec.doc.info - The Icon For the Docs.
  54.  
  55.  
  56. ABOUT DISKEXEC:
  57. --------------
  58.     DiskExec is a program (Actually a Commodity) that is a little bit hard
  59.  to describe.  It all started when I asked my friend Yanik Grignon to make
  60.  me a program to replace this old sharware Program I had lost called "DiskTalk"
  61.  which would play Sound Samples when a Disk was Inserted and Removed. After a
  62.  Long Discussion we decided we could make the Program Much better than that. We
  63.  decided it would not be limited to sound samples. Actually what the program
  64.  does is Executes literaly anything when a disk is inserted or removed. Actualy
  65.  any two things as the Program treats each task (Insert,Remove) seperatly,hence
  66.  one executed task for insert, another for remove. I will discuss
  67.  applications of the program later on in the manual.
  68.  
  69.  
  70. DISKEXEC'S SYSTEM REQUIREMENTS:
  71. ------------------------------
  72.     As DiskExec is a Commodity, it requires OS2.04 or later. If you require
  73. a version of DiskExec for Workbench 1.3 or earlier, Send us Mail
  74. (Electronic or snail) at the Address at the begining of this Doc. Of course
  75. the OS1.3 version is a Command Line (CLI) version only. 
  76.  
  77.    Although a HardDrive is not a Neccessity (due to DiskExec's size) it
  78. will make the Program a lot more usefull and Quicker.
  79.  
  80.     DiskExec has been tested on several Systems ECS, and AGA to ensure
  81. compatibitly. I Personaly have tested it on an A500,A2000HD (Accelerated
  82. and Not), and an A1200HD. It works like a charm on all of em.
  83.  
  84.  
  85. APPLICATIONS FOR DISKEXEC:
  86. -------------------------
  87.     This is a Really hard section to write as the Posibilities are truely
  88. Endless. But I Will List a few of the More Common Ones People would want to
  89. use this Program for..
  90.  
  91.     As I said earlier, DiskExec Will Literaly run anything when it detects
  92. a Disk Insert/remove because Yanik programed it to Actually execute a
  93. Command line. So Anything that can Be Executed, be it Program, Script,
  94. etc.. will work with DiskExec. Simply place your Command line in the
  95. Tooltypes to have DiskExec execute them. Now for some Examples:
  96.  
  97. 1) Sound Samples: This is What I use DiskExec for. All you need to make
  98. DiskExec to Play sound Samples is a Sample Player (SMPlay included in the
  99. SoundMachine Package or Play8SVX included in ReqTools Package are good
  100. ones) and Sound Samples. Here is my Tooltypes List for Playing Sound
  101. Samples:
  102.                  CX_PRIORITY=0
  103.                  INSERTED=Play8SVX dh0:s/DE_IN.iff
  104.          REMOVED=Play8SVX dh0:s/DE_Out.iff
  105.         
  106.                           ^^Player    ^^Path and Sample
  107.  
  108. In Other Words you place the actual command line as if you were going to
  109. run it in a Shell Manualy, so DE knows and can do this Automaticly.
  110.  
  111. 2) Load a Picture: Someone pointed out to us that it would be funny to have
  112. your System display Some kind of Picture With a "Thank you for Inserting a
  113. Disk" or "a Disk has been Inserted" text in it. If you wish to do this too,
  114. all you'll need is a Picture Viewer and Pictures. A neat way of Customizing
  115. your WorkBench.
  116.  
  117. 3) Loging Disk Activity: This is very usefull for Networked Amigas as well
  118. as Normal Users. For a Network of Amigas Disk Exec can keep track of Every
  119. Disk Put into the Network by Using DiskExec to Log all Disks (and there
  120. Names, or Content if you wish) being inserted into the Computers of your
  121. Network. This is Very good for Ensuring no one is Bringing and Playing
  122. games and/or Copying (c)opyright Software on your Network. The reasons for
  123. loging disks are Numerous. For the Regular user, you can use this Loging of
  124. Disks by DiskExec to Track Down that Elusive Virus that keeps Plaguing your
  125. Amiga.. When you load your Computer, And have DiskExec configured for
  126. Loging Disks, Every disk you insert will be loged and when a Virus is
  127. Detected on your System you need only look in your log file for the disks
  128. you inserted. One of these Disks is the Infected one..
  129.  
  130. 4) Executing a Script: This I leave up to the User to Imagine. It can be
  131. used to aid the Log Disk Process (ie. you can have a Script that logs the
  132. Disk Name, Content, time of day, and date) thus when a Disk is inserted the
  133. Script will be run, thus loging all the info you require on that Disk.
  134. Other Uses are left to the Imagination of the User.
  135.  
  136.  If you Find any other Usefull uses of DiskExec Please let Us know so
  137. we can include it in the Next Version. Share the Wealth as they Say.
  138.   
  139.  
  140. HOW TO USE DISKEXEC:
  141. -------------------
  142.     DiskExec is Extremly easy to use as it is a Commodity. Simply Drag its
  143. Icon into your WBStartup Drawer, Set the ToolTypes, and Run it (or Reboot).
  144. To Kill it, simply Run it a second time or use Exchange.
  145.  
  146.  
  147. SETTING THE TOOLTYPES:
  148. ---------------------
  149.  To configure the Tooltypes Simply Click Once on DiskExec's Icon and
  150.  Select Information in the ICONS menu of WorkBench. Please Remove the (,)'s
  151. that surround the tooltype to be able to use them.
  152.  
  153. CX_PRIORITY=0      : This Tooltype allows you to set the Priority of the
  154.              Commodity which if set to a higher value will give
  155.              DiskExec Priority over other Commodities. 
  156.  
  157. INSERTED=<command> : This is where you put your Command line for a Disk
  158.              Being Inserted. Simply delete the "<command>" and
  159.              place your own command line right after the = (no
  160.              space after the "=")
  161.  
  162. REMOVED=<command>   : This is where you put your Command line for a disk
  163.              being Removed. Simply delete the "<command>" and
  164.              place your own command line right after the = (No
  165.              space after the "=")
  166.  
  167.  
  168. HISTORY:
  169. -------
  170.  
  171. DiskExec has been changed Dramaticly since its First Beta Release. For One
  172. thing. It was Originaly Programed in E. This was for two Reasons. 1) He was
  173. programming in E when I asked him about my Idea and 2) as a Test to see if
  174. he could do it in E. The Original CLI Version (in E) worked very well but
  175. We wanted to make it a Commodity. After weeks of trying to get the program
  176. to to read information out of the tooltypes, Yanik gave up on E and rewrote
  177. DiskExec in C. After Switching to C, the Commodity version emerged rather
  178. quickly.
  179.         ***Programers Note: If anyone knows how to get an E Program to read
  180.            its Info from the Icon ToolTypes, I am Still interested in finding
  181.            out to further my knowledge of E and for Future Projects..***
  182.  
  183. Version #'s:                       Comment:
  184. -----------               -------
  185.   0.10               Original CLI Version (written in E - Never Released)
  186.   Several #'s        First Attempt at Commodity Version in E (Never Worked)
  187.   0.90               First Beta Release of Commodity (Re-Written in C)
  188.   1.00               First Official Release of DiskExec (Commodity Version)
  189.  
  190.  
  191.      ------------------------------------------------------------------
  192.      \/\/\/\/\/\/\/\/\/\/\/\/\/\/ THE END /\/\/\/\/\/\/\/\/\/\/\/\/\/\/  
  193.      ------------------------------------------------------------------
  194.